pp108 : Web Services Interface

Web Services Interface
This topic describes the various fields on the tabs of the Web Services tab interface.

The Web Services tab interface is used to configure the fields on the various tabs of the Web Services tab interface. The Read, and the Modify tabs appear on the Web Services tab depending upon the Entity Type option selected on the MDM Data Entity Interface while creating a data entity. The following tabs are displayed:

  • If the Send and Receive Data option of the Entity Type is selected while creating a hub data store, the Read and the Modify tabs are displayed.
  • If the Send Data only option of the Entity Type is selected while creating a hub data store, the Read tab is displayed.
  • If the Receive Data only option of the Entity Type is selected while creating a hub data store, the Modify tab is displayed.

Table 1. Fields on the Read tab

Field

Description

Web Service Operation

Select a Web service to read the data. Perform the following steps to select a Web service Operation:
1.Click next to Web Service Operation. The Select a Webservice Operation dialog box appears.
2.Click the relevant Web service. The selected Web service appears in the text box next to Web Service Operation.

Note:

  1. Selecting a Web service to read the data is optional for a hub data entity.
  2. Click (Remove Web Service) to clear the Web service that you have specified.

Web service Request Parameters > Threads

Threads facilitate to upload the data in batches. Thread1 appears by default under the Threads column on selecting the Web service. Click (Insert) to add more threads.

Web service Request Parameters > Parameter

When you select a Read Web service, the WSDL is read and its input parameters are displayed. The input parameter name to specify the range of values in the batch is displayed under the Parameter column.

Web service Request Parameters > XPath

The XPath of the input parameter in the request is displayed. For example, if '/' is displayed, it indicates that it is the immediate child of the request.

Web service Request Parameters > Value

Specify the range values. For example, specify the range values as range1: 0-100, range2: 101-200. If the range is very large, for performance improvement, you can add more than one thread. The threads run in parallel to improve the performance.

 

Table 2. Fields on the Modify tab

Field

Description

Update Web Service Operation

Select a Web service to update the data. Perform the following steps to select a Web service Operation:
1.Click next to Update Web Service Operation. The Select a Webservice Operation dialog box appears.
2.Click the relevant Web service. The selected Web service appears in the text box next to Update Web Service Operation.

Note:

  1. Selecting a Web service to update the data is optional for a hub data entity.
  2. The Update Web Service field only appears on selecting the Transactional option.
  3. The Insert Web Service and the Delete Web Service appear only on selecting the Non-Transactional (External Web Service, etc) option.
  4. Perform the steps to select the Web services for Insert Web Service to insert the data, and for Delete Web Service to delete the data.

 

Table 3. Fields on the Web services Transformations tab. The Web services Transformations tab appears only if you choose the Non-Transactional (External Web Service) option of the Entity Type while creating a data entity.

Field

Description

XPath From Read Response

Specify the XPath from the response of the Read Web service that matches the schema of the your business object.

Read Transformation

Specify a data transformation that you have created. Perform the following steps to select a data transformation:
1.Click . The Select a Data Transformation dialog appears.
2.Select the relevant data transformation that you have created.
Note: While creating the data transformation, ensure that you have selected a data transformation between the schema that you get after evaluating the XPath and the schema fragment of the business object, if the schema fragment that you get after evaluating the XPath is not same as the business object schema fragment.
3.The data transformation appears in the text box next to Read Transformation.
Note:

  1. Specifying a data transformation is optional.
  2. Click (Remove Transformation) to clear the read transformation that you have specified.

Update Transformation

Specify a data transformation that you have created. Perform the following steps to select a data transformation:
1.Click . The Select a Data Transformation dialog appears.
2.Select the relevant data transformation that you have created.
Note: Ensure that you have selected the business object as source schema fragment and the composed Update Web service request as the target while creating the data transformation.
3.The data transformation appears in the text box next to Update Transformation.
Note: Perform the above steps to specify the data transformations for Insert Transformation and Delete Transformation.